home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / bbs_door / qrzd108.zip / QRZDOOR.DOC < prev    next >
Text File  |  1996-04-04  |  9KB  |  217 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                      QRZDOOR online Amateur Callbook Door
  11.                                  version 1.08
  12.  
  13.                               Copyright 1995/96
  14.                                       by
  15.  
  16.                           Pass - the - Buck SoftWare
  17.                               Independence, Mo.
  18.  
  19.                                    (W4KGU)
  20.  
  21.  
  22.     Files included in this package:
  23.  
  24.     QRZDOOR.EXE
  25.     QRZDOOR.CFG
  26.     QRZDOOR.DOC
  27.     HISTORY.TXT
  28.  
  29.          Please  be  sure  all files are included when  you  install  this
  30.     software.    Please  DO NOT distribute this program if ANY  files  are
  31.     missing.
  32.  
  33.          The  QRZDOOR  program  was  developed  and  tested  on  land-line
  34.     Bulletin Board Systems using the following hardware / software:
  35.  
  36.               386/40 IBM clone
  37.               8250 / 16550 UART serial cards
  38.               PPI 14,400 / 28,800 modems
  39.               RemoteAccess BBS software
  40.               (running under MS Windows)
  41.               Generic Single speed CD-ROM drive
  42.               QRZ! CD Vol 4., Winter 1995
  43.               QRZ! CD Vol 5., July 1995
  44.               QRZ! CD Vol 6., Jan 1996
  45.  
  46.          While  no two systems are alike,  one similar to the above should
  47.     offer few problems in setting up and running QRZDOOR.
  48.  
  49.          There is no charge for this program.  I would appreciate a QSL or
  50.     netmail  to know that you are using it.   I would also appreciate  any
  51.     feedback you may have on its operation and,  of course, the inevitable
  52.     bug reports.   I cannot guarantee to update the software and accept no
  53.     obligation for future releases.  This is FREE, you know!
  54.  
  55.          If you are using this program in a system substantially different
  56.     from the one outlined above, I would appreciate a note letting me know
  57.     of any special steps or settings you have made to make it function for
  58.     you.    I will pass these along to others who may have similar systems
  59.     or problems with particular pieces of hardware/software.
  60.  
  61.          All  Hardware and Software products mentioned in this document by
  62.     name   are   the  sole  exclusive  properties  of  their  authors   or
  63.     manufacturers.
  64.  
  65.     INSTALLATION
  66.  
  67.          Installation is simple.   Make a directory,  put all the files in
  68.     it.
  69.  
  70.          If  you  are running your BBS on a slow system you may  copy  the
  71.     four  index  file  (.IDX)  from the CD's CALLBK directory  to  the  HD
  72.     directory  where  QRZDOOR.EXE lives.   This may speed access for  your
  73.     users.    If QRZDOOR can't find the index files in its home directory,
  74.     it will use the path in the .CFG file.  Try it both ways and see which
  75.     works best on your system.   NOT moving the files makes changing disks
  76.     simpler  and less prone to errors due to forgetting to move the  files
  77.     from an upgrade disk.
  78.  
  79.          Using  an  ASCII  text  editor,  edit  the  QRZDOOR.CFG  file  as
  80.     necessary for your installation.
  81.  
  82.          Beyond a CD-ROM drive and a copy of QRZ!,  the only thing QRZDOOR
  83.     requires  is that the BBS create a DORINFO1.DEF drop file.   This file
  84.     contains all user and system information to operate correctly with any
  85.     BBS package.  If your BBS software doesn't create this file, there are
  86.     programs  available on most large full service systems to convert your
  87.     dropfile  to  the  correct format.   It is beyond the  scope  of  this
  88.     document to discuss how this is done.
  89.  
  90.          Make a menu selection on your BBS that will allow it to shell out
  91.     to run QRZDOOR.  It is important that a new instance of DOS be created
  92.     for  QRZDOOR.    The program uses many DOS functions and will fail  to
  93.     operate  if attempting to run in the same instance of DOS as the  BBS.
  94.     (See your BBS documentation).  It is not necessary on most systems for
  95.     the BBS software to swap itself out of memory.   QRZDOOR is very small
  96.     and  memory  efficient.  Not  swapping the BBS software out of  memory
  97.     will allow QRZDOOR to load and unload faster for your users.
  98.  
  99.          Make  a  batch file that will make the current working  directory
  100.     the  one where QRZDOOR lives.   This is important.   QRZDOOR will only
  101.     operate from its own directory.  This is done very simply :
  102.  
  103.     REM ** Batch file to run QRZDOOR with any BBS
  104.     REM **
  105.     CD D:\RA\CALLBOOK
  106.     QRZDOOR.EXE
  107.     CD D:\RA
  108.  
  109.          The  last  line  insures that the current  working  directory  is
  110.     returned  to  the BBS directory when QRZDOOR is finished.    You,   of
  111.     course,  will want to write this batch with paths that are significant
  112.     to your installation.
  113.  
  114.          Call  this batch file,  NOT the QRZDOOR program,  from your  menu
  115.     selection.
  116.  
  117.          QRZDOOR  requires a 5 line configuration file.   There are so few
  118.     lines  needed  and none that require changing often enough to make  it
  119.     real fancy.  You may edit the one included in this file or create your
  120.     own with an ASCII text editor.  The lines MUST appear in the following
  121.     order:
  122.  
  123.     BBS NAME as it should appear in normal printed form.
  124.     BBS PATH where DORINFO1.DEF will be dropped.
  125.     QRZ! PATH drive letter of CD-ROM drive followed by :\
  126.     FILE PATH path to where download file can be placed.
  127.     FILE INFO text string displayed to user if file created.
  128.     TIME LIMIT time user is allowed to stay in door.
  129.  
  130.     On my system, this file looks like this:
  131.  
  132.     The HamShack BBS
  133.     d:\ra
  134.     g:\
  135.     d:\archive\incoming
  136.     File may be downloaded from File area #2
  137.     10
  138.  
  139.          No  other  characters  or delimiters are allowed  in  this  file.
  140.     Change the paths to match your system and you are in business.
  141.  
  142.          The  file information string will be displayed to the user before
  143.     logoff if he has created a listing file for download.   It may contain
  144.     up to 70 characters and spaces MAXIMUM.   It MUST contain at least one
  145.     character.  If you place a single space in this line no string will be
  146.     displayed.
  147.  
  148.  
  149.     FEATURES
  150.  
  151.          QRZDOOR is user friendly.   Single character commands are used to
  152.     change modes and activate features.   ANY single character followed by
  153.     an <ENTER> key will be treated as a command.  If it is a valid command
  154.     it will be operated on.  If it is not a valid command it will ring the
  155.     bell and return to the prompt.
  156.  
  157.          QRZDOOR has built in Help.   Just press the H key and hit <ENTER>
  158.     and the program operation is explained.
  159.  
  160.          QRZDOOR has built in carrier watch.   If line noise, call waiting
  161.     or  rudeness knock your user off-line,  the program exits back to  the
  162.     BBS instantly.
  163.  
  164.          QRZDOOR has built in inactivity time out.   While waiting at  any
  165.     prompt,   if  the user falls asleep or gets locked up,  (most of  them
  166.     should be!)  a wake up bell is sent after 2 minutes and the door exits
  167.     to the BBS after another minute of inactivity.
  168.  
  169.          QRZDOOR allows the user to create a downloadable text file of the
  170.     listings he has need of.   Up to 100 listings may be added to the file
  171.     which should keep the file size under 20K.   The F command is a toggle
  172.     and  may  be used to turn the file save on and off until  the  maximum
  173.     number of listings has been reached.
  174.  
  175.          QRZDOOR  works  locally  just  as  it  does  online.    The  only
  176.     difference you should notice is that in local mode,  the status bar at
  177.     the  bottom  of the screen showing user name,  port,  etc.   will  not
  178.     appear.  It is assumed that you know you are the user and that you are
  179.     logged on locally.
  180.  
  181.     LEGAL STUFF
  182.  
  183.          No Guarantees of anything under any circumstances.   If you can't
  184.     accept  the risk and responsibility then simply don't load or run this
  185.     software!
  186.  
  187.          Fred Lloyd,  AA7BQ, has spend countless hours, effort, energy and
  188.     gone  to  great expense to create the QRZ!   CD-ROM.   He has done  an
  189.     excellent  job  of  putting so much software and  information  in  one
  190.     package.    He  is to be congratulated and I would like to  take  this
  191.     opportunity to express my appreciation.
  192.  
  193.  
  194.          You may reach me at any of the following addresses:
  195.  
  196.     w4kgu@sound.net                                   InterNet
  197.     sysop@f19.n280.z1.fidonet.org
  198.  
  199.     http://www.sound.net/~w4kgu                       World Wide Web
  200.  
  201.     Dave Perry                                        FidoNet
  202.     1:280/19
  203.  
  204.     Dave Perry                                        SnailMail
  205.     W4KGU
  206.     Current Callbook Address
  207.  
  208.          I  attempt  to answer all questions except those that  reflect  a
  209.     complete   lack   of   understanding  of  computers,    DOS,    serial
  210.     communications,   BBS software,  paths,  file names,  batch files  and
  211.     ANSI.SYS.
  212.  
  213.  
  214.                                      -73-
  215.  
  216.  
  217.